TextSnapshot.setSelectColor()

Доступность

Среда разработки: Flash MX 2004.

Плеер: SWF файлы, опубликованные для Flash Player 6 или более поздних версий, проигрываются во Flash Player 7 и более поздних.

Синтаксис

my_snap.setSelectColor(hexColor:Number);

Параметры

hexColor Цвет рамки вокруг символов, выбранных при помощи метода TextSnapshot.setSelected(), в формате 0xRRGGBB.

Возвращает

Ничего.

Описание

Метод; определяет цвет, которым выделяются символы, выбранные при помощи метода TextSnapshot.setSelected(). Прозрачность для цвета задать нельзя.

Этот метод работает корректно только со шрифтами, имеющими метрические данные о символах ; по умолчанию, Flash не включает эту информацию для статических полей. В некоторых случаях из-за этого метод возвращает -1 вместо индекса. Чтобы убедиться, что возвращаться будет индекс, вы можете принудительно включить метрические данные о шрифте в среде разработки. Для этого добавьте на Сцену текстовое поле, использующее этот же шрифт, выберите опцию Character Options и укажите, что в ролик должен быть внедрен один символ. Не важно, какой именно символ(ы) вы выберите, даже если это будет символ, не используемый в статическом текстовом поле.

Пример

Код в нижеследующем примере показывает, как пользоваться данным методом. Перед использованием этого кода, разместите на Сцене статическое текстовое поле с текстом “TextSnapshot Example”. Добавьте следующий код в AS или FLA файл.

Замечание: Если вы не видите рамки вокруг выделенных символов, вам необходимо разместить на Сцене динамическое текстовое поле и произвести ряд действий. Смотри пункт “Описание” в этом разделе.

// В этом примере предполагается, что мувиклип содержит
// статическое текстовое поле с текстом "TextSnapshot Example"
var my_snap:TextSnapshot = this.getTextSnapshot();
var count:Number = my_snap.getCount();
my_snap.setSelectColor(0xFF0000); // задаем цвет рамки красным.
my_snap.setSelected(0, 4, true); // выбираем первые четыре символов.
my_snap.setSelected(1, 2, false); // снимаем выделение со второго символа (оставляя остальные выбранными)

var firstCharIsSelected:Boolean = my_snap.getSelected(0, 1);
var secondCharIsSelected:Boolean = my_snap.getSelected(1, 2);
var theText:String = my_snap.getSelectedText(false); // узнаем, какой текст выбран
trace(theText); // выводит: Txt
trace(firstCharIsSelected); // выводит: true
trace(secondCharIsSelected); // выводит: false

При тестировании SWF файла, вы должны увидеть цветной прямоугольник вокруг выбранных символов.

Посмотреть комментарии LiveDocs

Предыдущая | Следующая | Оглавление